SetGroupPathCamSwitch

使用轴组的移动距离来控制触发数位输出的开关。当组移动一定的距离后，开关即开启或关闭，而开关可受组的向前或向后运动控制。

语法

KsCommandStatus SetGroupPathCamSwitch(
     int Index,
     KsCommandStatus MotionCommand,
     int SwitchLength,
     McCamSwitch* Switches,
     int TrackLength,
     McOutput* Outputs,
     McTrack* Tracks,
     DWORD EnableMask
);

参数

Index [in]：轴组索引，索引以零为起点。最多可有 32 个轴组。

MotionCommand [in]：凸轮开关附加的组运动命令的命令状态。

SwitchLength [in]：在开关阵列的开关数量，每一轨道最多可有八个开关，SwitchLength 范围为 0 至 24。

Switches [in]：控制开关动作，轨道数量必须依照顺序排列。请见 McCamSwitch 结构。

TrackLength [in]：轨道阵列中的轨道数量，输出与轨道的长度必须一致。例如，有两个输出就必须有两个轨道，TrackLength 的范围为 1 至 3。

Outputs [in]：选择对应轨道所控制的数位输出。请见 McOutput 结构。

Tracks [in]：将补偿时间和迟滞添加到轨道上的开关，Switches 中可见 TrackNumber 之定义。请见 McTrack 结构。

EnableMask [in]：启用不同轨道，此参数为 BOOL 32 位元，当 BOOL 值设为一时将启动轨道阵列中的相应轨道。

回传值

返回 KsCommandStatus 结构。

备注

• 此函式与 SetAxisCamSwitch 运作方式相同。
• 每个组运动命令只能附加到一组凸轮开关（最多 24 个开关）。
• 一个轴组最多可以有三个路径凸轮开关。
• 一组路径凸轮开关最多可有三个轨道。
• 组路径凸轮开关可用于以下功能：
• MoveLinearAbsolute
• MoveLinearAdditive
• MoveLinearRelative
• MoveCircularAbsolute
• MoveCircularAdditive
• MoveCircularRelative
• MoveHelicalAbsolute
• MoveHelicalAdditive
• MoveHelicalRelative

不支援其他如 InchGroup 与 JogGroup 之组运动函式。

范例

N/A

使用需求

	RT	Win32
最低支援版本	4.1	4.1
标头档	ksmotion.h	ksmotion.h
程式库	KsApi_Rtss.lib	KsApi.lib

参见

SetAxisCamSwitch